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出 局 
关于 本 指南 和 技术 支持 信息 
关于 本 手册 


用 户 通过 该 手册 能 快速 获取 有 关 赛 上 科 技 上 : 星 光 2 的 基本 信息 ， 包 括 功 能 、 规 格 、 板 外 观 和 
pin， 以 及 Debian 操 作 系 统 入 门 指南 。 
修订 历史 
表 0-1 修订 历史 
发 布 说 明 
2023/08/14 * 在 肪 :星光 2 启动 模式 设置 (第 49 页 ) 新 增 了 一 个 注释 。 
。 在 硬件 准备 (第 19 页 ) 新 增 了 所 需 硬件 。 


。 在 将 OS 烧 录 到 Micro-SD 卡 上 (第 21 页 ) 新 增 了 关于 
Debian 镜 像 的 信息 。 

。 将 更 新 SPL 和 U-Boot {第 36 页 ) 和 在 SD 卡 和 eMMC 上 六 
展 分 区 (第 33 页 ) 小 节 移 动 到 了 快速 入 门 章节 ， 作 为 使 
用 单 板 计算 机 的 必要 步骤 。 

。 新 增 了 以 下 部 分 : 


。 避免 运行 apt upgrade (第 32 页 ) 


"安装 软件 包 (第 35 页 ) 
。 编译 和 更 新 Linux 内 核 (第 40 页 ) 
。 自 定义 Debian (第 42 页 ) 
* 更 新 了 编译 和 更 新 Linux 内 核 (第 40 页 ) 中 的 路 径 。 


。 更 新 了 硬件 准备 (第 19 页 ) 中 SSD Mounting 
Location 的 图 片 。 


2023/06/13 “修正 了 拼写 错误 。 

。 更 新 了 更 新 Flash 中 的 SPL 和 U-Boot (第 36 页 )。 
2023/05/10 更 新 了 肪 :星光 2 启动 模式 设置 (第 49 页 )。 
1.61 2023/04/28 将 硬件 准备 (第 179 页 ) 中 的 注释 类 型 改 为 警告 。 


表 0-1 修订 历史 ( 续 ) 
发 布 说 明 


修订 


2023/04/19 


。 更 新 了 恢复 Bootloader (第 43 页 ) 中 恢复 文件 的 版 本 信 
。 在 更 新 Flash 中 的 SPL 和 U-Boot (第 36 页 ) 新 增 了 一 个 注 


2023/04/12 


。 修正 了 拼写 错误 。 
。 在 登录 Debian 时 ， 增 加 了 配置 启动 模式 的 步骤 。 
。 更 新 了 通过 以 太 网 使 用 SSH Root 账 户 登 录 (第 42 页 ) 的 


会 作 
Hi Yo 


。 更 新 了 更 新 SD 卡 和 eMMC 中 的 SPL 和 U-Boot (第 
页 ) 的 命令 。 


2023/04/03 


2023/03/28 


。 在 登录 Debian (第 23 页 ) 更 新 了 登录 注释 。 
* 修改 了 附录 部 分 通过 以 大 网 使 用 SSH Root 账户 登录 (第 


42 页 ) 的 位 置 。 
更 新 了 登录 Debian 的 用 户 名 。 


2023/02/28 


2022/12/27 


更 新 如 下 小 节 : 
。 更 新 了 在 SD 卡 和 eMMC 上 扩展 分 区 (第 33 页 )。 


。 在 通过 以 太 网 使 用 SSH Root 账户 登录 (第 42 页 ) 添 加 了 
安装 coBenssn-server 软 件 安装 包 的 步骤 。 


。 在 更 新 SPL 和 U-Boot (第 36 页 ) 新 增 了 一 个 方法 。 


* 在 硬件 准备 (第 19 页 ) 新 增 了 推荐 的 SSD 安 装 螺丝 信 
号 。 


更 新 如 下 小 节 : 
* 移 除 登录 Debian (第 23 页 ) 中 多 余 的 步骤 。 
* 在 通过 以 太 网 使 用 SSH 登 录 (第 25 页 ) 增 加 了 第 1 步 。 
。 在 更 新 Flash 中 的 SPL 和 U-Boot (第 36 页 ) 新 增 了 一 个 更 
新 方法 。 
* 更 新 了 GitHub 代 码 仓 地 址 (第 48 页 ) 中 的 DTS 文 件 链 


接 ; 


。 在 恢复 Bootloader (第 43 页 ) 增 加 了 示例 输出 图 片 。 


2022012021 


注释 和 注意 事项 
本 指南 中 可 能 会 出 现 以 下 注释 和 注意 事项 : 


.©@ 提示 : 


建议 如 何在 某 个 主题 或 步骤 中 应 用 信息 。 
注 : 
解释 某 个 特例 或 阐释 一 个 重要 的 点 。 


指出 与 某 个 主题 或 步骤 有 关 的 重要 信息 。 


表明 某 个 操作 或 步骤 可 能 会 导致 数据 丢失 、 安 全 问题 或 性 能 问题 。 


. 0 二: 
© 
全 


警告 : 


表明 某 个 操作 或 步骤 可 能 导致 物理 伤害 或 硬件 损坏 。 
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1. 功能 与 规格 


本 章 介绍 了 上 防 .星光 2 的 功能 与 规格 。 


1.1. 功能 


防 .星光 2 功能 如 下 : 
. 硬件 (第 10 页 
记 口 (第 11 页 

.软件 (第 12 页 


1.1.1. 硬件 


本 节 从 以 下 几 方 面 介绍 防 .星光 2 的 硬件 特性 : 
* 处 理 器 (第 10 页 
第 10 页 


“ 视频 处 理 (第 10 页 ) 


处 理 器 


。 赛 防 科 技 肪 - 惊 鸿 -7110 RISC-V 四 核 64 位 RV64GC ISA SoC 搭 载 2MB L2 缓 存 和 协 处 理 器 ， 
工作 频率 最 高 可 达 1.5 GHz 


。|IMG BXE-4-32 MC1， 工 作 频 率 最 高 可 达 600 MHz 


内 存 


防 .星光 2 提供 2 GB、4 GB、8 GB LPDDR4 SDRAM 系 统 内 存 配置 选项 ， 数 据 传输 速率 最 高 可 达 
2,800 Mbps 


存储 
。 板 载 TF 卡 插 槽 : 防 .星光 2 可 从 TF 卡 启 动 
。 | 闪存: 存储 U-Boot 和 Bootloader 的 固件 
视频 处 理 
防 .星光 2 的 视频 处 理 有 以 下 特性 : 
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。 视 频 解 码 (H.264/H.265) 最 高 达 4K@60fps， 支 持 多 路 解码 
。 视 频 编 码 (H.265) 最 高 达 1080p@30fps， 支 持 多 路 编码 
。JPEG 编 解码 


1.1.2. 接口 


。1 x 2-lane MIPI DSI 
“1 x 4-lane MIPI DSI 
。1 x 2-lane MIPI CSI 
“1 x 3.5 mm 音频 插 孔 
“1 x USB-C 接 口 (用 于 充电 ) 
“1 x USB device 接 口 (和 USB-C 接 口 复 用 ) 
。4 x USB 3.0 接 口 (通过 PCle 2.0 1 x lane 复 用 ) 
“1 x HDMI 2.0 
“2 x RJ45 以 太 网 接口 
。1 x 4-pin PoE header 
。1 x 2-pin 风 扇 接口 
“1 x 复位 键 
。1 x 40-pin GPIO header， 支 持 多 种 接口 选项 : 
°3.3V (2 pins) 
°5V (2 pins) 
。 接 地 接口 (8 pins) 
。GPIO 
。CAN 总 线 
»° DMIC 
° |2C 
° |2S 
。 PWM 
。SPI 
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1.1.3. 软件 


操作 系统 
防 .星光 2 支持 Debian 操 作 系 统 。 


如 需 获取 更 多 软件 资源 ， 请 访问 赛 上 科 技 GitHub 仓 亩 。 


1.2. 规格 


防 .星光 2 规格 如 下 : 


赛 防 科技 防 . 惊 鸿 -7110 


赛 防 科技 防 . 惊 鸿 -7110 RISC-V 四 核 64 位 RV64GC 
ISA SoC 搭 载 2MB L2 缓 存 和 协 处 理 器 ， 工 作 频 京 
最 高 可 达 1.5 GHz 


Imagination GPU 


2 GB/4 GB/8 GB 


板 载 TF 卡 插 槽 


IMG BXE-4-32 MC1， 工 作 频 
MHz 


LPDDR4 SDRAM,， 传输 速 度 最 高 可 达 2,800 Mbps 


防 .星光 2 可 从 TF 卡 启动 


闪存 
视频 输出 


存储 U-Boot 和 Bootloader 的 固件 


。1 x 2-lane MIPI DSI 显 示 接 口 ( 
1080p@30fps) 


“1 x 4-lane MIPI DSI 显 示 接 口 ， 在 单 屏 显示 
和 双 屏 显示 模式 下 支持 最 高 2K@30fps 


。1 x HDMI 2.0， 支 持 最 高 4K@30fps 或 
2K@60fps 


肉 注 : 


两 个 MIPI DSI 接 口 不 得 同时 使 用 。 


摄像 头 1 x 2-lane MIPI CSI 摄 像 头 接口 ， 支 持 最 高 
1080P@30fps 
编 解码 。 视 频 解 码 (H264/H265) 最 高 达 


4K@60fps， 支 持 多 路 解码 


。 视频 编码 (H265) 最 高 达 1080p@30fps， 
支持 多 路 编码 


。JPEG 编 解码 
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描述 


4 极 立 体 声音 频 插 孔 


以 太 网 2 x RJ45 千 兆 以 太 网 接口 


USB Host 


4 x USB 3.0 接 口 (通过 PCle 2.0 1 x lanes 复 用 ) 


USB Device 
2 连接 器 
eMMC 插 槽 


1 x USB device 接 口 (和 USB-C 接 口 复 用 ) 


用 于 eMMC 模 块 ， 如 操作 系统 和 数据 存储 


2-Pin 风 扇 接口 
USB-C 接 口 


通过 USB-C PD 快 充 端口 输入 5 V DC， 最 高 30 
W (最 低 3 A) 


GPIO 电 源 输 入 


通过 GPIO header 输 入 5 V DC (最 低 3 A) 


PoE (以 太 网 供电 ) 


GPIO: 40-Pin GPIO Header 


可 启用 PoE 功 能 ， 使 用 此 功能 需要 另行 购买 PoE 
拓展 版 


1 x 40-pin GPIO header， 支 持 多 种 接口 选项 
“3.3V (2 pins) 


。5V (2 pins) 
“接地 接口 (8 pins) 
。 GPIO 

“ CAN 总线 

。DMIC 

。|2C 

*|2S 

。PWM 

。 SPI 

* UART 


等 
< 


启动 模式 启动 模式 pin 设 置 


您 可 以 选择 以 下 启动 模式 之 一 : 
。1-bit QSPI Nor Flash 
* SDIO3.0 
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Reset 键 需要 重 置 防 :星光 2 时 ， 请 长 按 Reset 键 3 秒 以 上 ， 
以 确保 重 置 成 功 。 


100 x 74 mm - 


RoHS, FCC, CE 
0-50 °C 


40-pin GPIO header 提 供 UART TX 和 UART RX 功 


GE 
用 
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2. 硬件 简介 


本 章 介绍 了 防 .星光 2 的 硬件 信息 。 


2.1. 产品 框图 


图 2-1 肪 :星光 2 外 观 (顶部 视图 ) 


2 StarFiVE vorivi 
方 科 接 
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图 2-2 防 .星光 2 外 观 (底部 视图 ) 


个 警告 : 


在 使 用 防 .星光 2 时 ， 避 免 接触 可 能 造成 开发 板 损 坏 的 硬 物 。 


表 2-1 组 件 介绍 


赛 旷 科 技 肪 - 惊 鸿 -7110 RISC-V 64 2 x 以 太 网 接口 (RJ45) 
位 四 核 RV64GC ISA 芯 片 平 台 
PoE Header HDMI 2.0 接 口 
Boot Mode Pins 3.5 mm 音频 插 孔 
40-Pin GPIO Header 2 x USB 3.0 接 口 
2 GB/4 GB/8 GB LPDDR4 SDRAM 2 x USB 3.0 接 口 
6 Reset 键 4-lane MIPI DSI 
7 EEPROM USB 3.0 主 机 控制 器 
8 USB-C 接 口 ， 可 用 于 供电 和 数据 |21 2-lane MIPI DSI 
传输 
9 2-lane MIPI CSI 22 eMMC 插 村 
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表 2-1 组 件 介绍 ( 续 ) 


描述 


2-Pin 风 扇 接口 


TF 卡 插 模 


QSPI Flash 


GMACO PHY 


M.2 M-Key 


GMAC1 PHY 


2.2. PIn 图 


以 下 是 肪 :星光 2 的 pin 图 : 
图 2-3 Pin 图 


GPIO58 (I2C SDA) 

GPIO57 (I2C SCL) 

GPIO55 

GND 

GPIO42 

GPIO43 

GPIO47 
33VPower 
GPIO52 (SPI MOSI) 

GPIO53 (SPI MISO) 


GPIO48 (SPI SCLK) 
GND 

GPIO45 

GPIO37 

GPIO39 

GPIO59 (PWM1) 
GPIOG63 

GPIO60 

GND 


全 


© © OO ® ©® ©®® ©®® ® 


GPIOS (UART TX) 
GPIO6 (UART RX) 
GPIO38 


GPIO50 

GPIO49 (SPI CEO) 
GPIOS56 

GPIO40 

GND 

GPIO46 (PWM0) 
GND 

GPIO36 

GPIO61 

GPIO44 
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注 : 


。 请 注意 每 个 GPIO pin 的 最 大 安全 电流 为 32 mA， 但 是 当 多 个 GPIO 同 时 使 用 ， 总 


流 应 小 于 100 mA。 超 过 最 大 值 将 损坏 pin。 
。 所 有 的 GPIO pin 都 可 以 配置 为 不 同 的 功能 ， 包 括 但 不 限于 
SDIO、Audio、SPI、I2C、UART 和 PWM。 相 关 操 作 请 参考 《 防 .星光 2 40-Pin 
GPIO Header 用 户 指 南 》。 
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3. 快速 入 门 


本 


章 介 绍 了 防 .星光 2 快速 入 门 的 步骤 。 


3.1. 硬件 准备 


确保 您 已 完成 以 下 硬件 准备 事项 : 


* 肪 :星光 2 

32 GB (或 更 大 ) 的 Micro SD 卡 

。 带 有 Linux/Windows/Mac 操 作 系 统 的 个 人 电脑 
。USB 转 串口 转换 器 

。 以 大 网 电缆 

。 电源 适配器 

“ USB Type-C 数 据 线 

“ 用 于 桌面 环境 使 用 : 


。 键 盘 和 鼠标 
。 显示器 或 电视 
。HDMI 电 缆 


* 此 外 ， 您 可 能 还 需要 一 些 可 选 组件 : 


。 以 太 网 LAN 电 缆 或 兼容 的 WiFi dongle (默认 启用 ESWIN6600U 或 AlIC8800 模 块 ) 


。USB 转 UART 串 行 转换 器 模块 


(i) 提示 : 


用 于 通过 UART 启 动 模式 进行 系统 恢复 。 


警告 : 


在 使 用 防 .星光 2 时 ， 避 免 接触 可 能 造成 开发 板 损 坏 的 硬 物 。 因 此 ， 赛 防 科 技 建议 您 为 


以 下 非 沉 铜 孔 (Non Plating Through Hole) 使 用 隔离 柱 : 
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3-1 肪 :星光 2 上 的 非 沉 铜 孔 


NPTH 1 


对 于 隔离 柱 ， 赛 防 科技 强烈 建议 您 使 用 以 下 规格 的 铜 柱 或 螺 柱 : 
。 单 头 六 角 铜 柱 (尺寸 : M2.5x*10 + 6mm) 
图 3-2 单 头 六 角 铜 柱 


“ 双 通 六 角 铜 螺 柱 (尺寸 M2.5*4) 
3-3 双 通 六 角 铜 螺 柱 


适用 于 防 .星光 2 的 SSD 安 装 螺丝 型 号 为 M2x3 mm ( 头 径 : 5.0 mm) 。 
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图 3-4 SSD 安 装 位 置 


3.2. 连接 风扇 


需要 散热 时 ， 您 可 连接 风扇 (2-pin，5 V) 到 防 .星光 2 上 ， 如 图 : 
图 3-5 连接 风扇 


本 本 轩 本 轩 本 本 本 本 本 本 本 本 本 本 国 【1 


40-Pin GPIO Header 
Boot Mode 图 


2/4/8 GB poE 


[ 

[ 

[ 
力 
1m 
+ 


LPDDR4 


m 

mm 

了 

必 

口 

三 
1lS] IdIWN 


JH7110 


Fan Header 


GMACO 
PHY 


USB 3.0 
Host 
Controller| 


3.3. 将 OS 烧 录 到 Micro-SD 卡 上 
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现在 我 们 需要 将 Debian (Linux 发 行 版 ) 烧 录 到 Micro-SD 卡 上 ， 以 便于 它 可 以 在 肪 :星光 2 上 运 
行 。 本 章 提 供 在 Linux 系 统 会 或 Windows 系 统 上 ， 将 Debian 烧 录 到 Micro SD 卡 上 的 示例 步骤 。 


3.3.1. Linux 系 统 或 Windows 系 统 


按照 以 下 步骤 ， 在 Linux 系 统 或 Windows 系 统 上 烧 录 镜像 : 
1. 使 用 Micro-SD 卡 读 卡 器 或 笔记 本 电脑 上 的 内 置 读 卡 器 ， 将 Micro SD 卡 连 接 至 计算 机 。 
2. 点 击 此 链接 下 载 最 新 Debian 镜 像 。 


注 : 
最 新 的 Debian 镜 像 位 于 202308 文 件 夹 中 。 请 确保 您 使 用 的 是 最 新 的 镜像 。 
由 于 肪 :星光 2 启动 模式 设置 (第 49 页 ) 中 包含 几 种 启动 模式 ， 因 此 还 准备 了 
不 同 的 Debian 镜 像 ， 包 括 : 
。NVME 镜 像 
“SD 镜 像 
。eMMC 镜 像 
因此 ， 根 据 您 的 偏好 ， 您 可 以 选择 性 的 下 载 镜 像 内 容 。 


3. 解压 .pz2 文 件 。 


下 载 的 镜像 为 一 个 img .bz2 压 缩 文件 。 为 提取 镜像 ， 您 需要 在 Windows/Linux 系 统 下 使 
用 压缩 工具 ， 如 7-Zip， 或 者 也 可 以 使 用 5zi52 命 令 压 缩 文件 。 


对 于 bzip2， 您 可 以 使 用 以 下 命令 ， 该 命令 将 删除 已 有 的 img.bz2 文 件 : 
bzip2 -qd <filename>.img .bz2 

为 保留 原始 文件 ， 您 需要 执行 以 下 命令 

bzip2 -dk <filename>.img.bz2 


4. 访问 此 链接 下 载 BalenaEtcher。 我 们 将 使 用 BalenaEtcher 将 Debian 烧 录 到 Micro SD 卡 上 。 
5. 安装 并 运行 BalenaEtcher。 
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图 3-6 安装 BalenaEtcher 
号 


I 


©@ Flashfrom URL 


加 Clone drive 


6. 点 击 Flash from file， 选 择 解压 后 的 镜像 文件 : 
starfive-jh7110-VF2-<Version> .md 
0 提示 : 
<Version> 表 示 Debian 镜 像 的 版 本 号 。 
7. 点 击 Select target， 并 选择 连接 好 的 Micro SD 卡 。 
8. 点 击 Flash! 开 始 烧 录 。 


3.4. 登录 Debian 


按照 以 下 步骤 ， 登 录 Debian: 
1. 通过 HDMI 将 显示 器 连接 到 防 .星光 2。 
2. 根据 要 求 设置 局 动 模式 。 有 关 说 明 ， 请 参见 5 
(i) 提示 : 


赛 上 防 科技 建议 您 使 用 1-bit QSPI Nor Flash 模 式 ， 因 为 QSPI Flash 中 的 SPL 和 U- 
Boot 版 本 可 能 需要 更 新 ， 如 需 更 新 SPL 和 U-Boot， 请 参阅 


O 


3. 将 烧 录 好 Debian 镜 像 的 Micro SD 卡 插入 到 防 .星光 2， 并 上 电 启 动 。 
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4. 输入 以 下 登录 信息 : 


。 Username: user 


。 Password: starfive 
5. 您 可 以 通过 以 下 方式 登录 Debian 操 作 系 统 : 


。 通过 HDMI 使 用 桌面 环境 登录 (第 24 页 ) 
。 通过 以 太 网 使 用 SSH 登 录 (第 25 页 ) 
。 使 用 USB 转 串口 转换 器 连接 并 登录 (第 25 页 ) 


如 果 您 需要 加 载 不 同 的 dtb 文 件 ， 请 按照 明 - 星 光 2 单 板 计算 机 软件 技术 参考 手册 中 "* 添 


0 提示 : 


你 
加 新 文件 "一 节 的 第 6 步 更 新 ./boot/uEnv .txt 文 件 。 


3.4.1. 通过 HDMI 使 用 桌面 环境 登录 


安装 Debian 后 ， 您 可 以 通过 HDMI 使 用 桌面 环境 在 肪 -星光 2 上 登录 Debian 操 作 系统 。 


连接 HDMI 显 示 器 后 ， 将 烧 录 好 Debian 镜 像 的 Micro SD 卡 捅 入 到 防 .星光 2， 并 上 电 启 


步骤 : 
1. 
动 。 

2. 当 登 录 界 面 出 现 后 ， 您 可 以 通过 防 .星光 2 使 用 键盘 和 鼠标 。 

3. 输入 以 下 登录 信息 : 
。 用 户 名 : user 
。 密码: starfive 

结果 : 
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屏幕 显示 如 下 图 所 示 : 
图 3-7 Debian 界 面 


debian 


3.4.2. 通过 以 太 网 使 用 SSH 登 录 
安装 Debian 后 ， 您 可 以 在 本 地 网 络 中 使 用 SSH 连 接 在 肪 :星光 2 上 登录 Debian 操 作 系统 : 
1. 将 烧 录 好 Debian 镜 像 的 Micro SD 卡 插入 到 上 . 星 光 2， 并 上 电 启 动 。 
2. 将 以 太 网 电费 的 一 端 连接 到 防 .星光 2 RJ45 接 口上 ， 将 另 一 端 连接 到 路 由 器 上 。 
3. 连接 成 功 后 ， 路 由 器 将 为 防 .星光 .2 分 配 IP 地 址 ， 此 后 防 .星光 2 就 能 连接 到 互联 网 。 
4. 请 根据 您 的 操作 系统 ， 选 择 相应 步骤 执行 : 
。Windows 系 统 (第 25 页 ) 


。Mac/Linux 系 统 (第 27 页 ) 


3.4.2.1. Windows 系 统 
1. 登录 到 路 由 器 (通常 ， 访 问 192.168.1.1 可 登录 到 路 由 器 ) 。 
2. 找到 DHCP 设 置 选项 ， 并 找到 防 .星光 2 的 IP 地 址 。 


各 提示 : 


通过 寻找 名 为 starfive 的 主机 名 ， 您 可 以 轻松 找到 防 .星光 2 的 IP 地 址 。 


3. 访问 此 链接 下 载 并 安装 Putty。 
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i 提示 : 


Putty 是 SSH 和 telnet 客 户 端 ， 您 可 以 通过 它 连 接 到 单 板 计算 机 。 如 果 已 经 安装 了 
Putty， 请 跳 过 此 步骤 。 


4. 打开 Putty 登 录 到 Debian。 

5. 选择 Connection Type 下 的 SSH。 

6. 设置 如 下 : 
。Host Name: 您 的 防 .星光 2 的 IP 地 址 
* Port: 22 

7. 点 击 Open。 


8. (可 选 ) 决定 您 的 用 户 名 。 如 果 和 您 义 需 要 使 用 root 帐 户 进行 远程 访问 中 的 特权 操 作 ， 请 按 
照 通 过 以 太 网 使 用 SSH Root 账户 登录 (第 42 页 ) 中 的 说 明 进 行 操 作 。 


肉 注 : 


如 您 无 需 使 用 root 账 户 进 行 登录 ， 请 跳 过 此 步骤 。 


9. 输入 以 下 登录 信息 : 
办 注 : 


如 您 需 使 用 root 账 户 进行 登录 ， 请 按照 第 3 步 操 作 执 行 ， 并 将 下 面 命 令 中 
的 Username 改 为 root。 


。 Username: user 


。 Password: starfive 
结果 : 
您 已 经 成 功 在 Windows 下 通过 SSH 连 接 到 防 .星光 21 


图 3-8 示例 输出 
学 starfive.local - PuTTY 口 Xx 
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3.4.2.2. Mac/Linux 系 统 


1. 登录 到 路 由 器 (通常 ， 访 问 192.168.1.1 可 登录 到 路 由 器 ) 。 
2. 找到 DHCP 设 置 选项 ， 并 找到 防 .星光 2 的 IP 地 址 。 
全 提示 : 
通过 寻找 名 为 starfive 的 主机 名 ， 您 可 以 轻松 找到 防 .星光 2 的 IP 地 址 。 


3，( 可 选 ) 决定 您 的 用 户 名 。 如 果 您 需要 使 用 root 帐 户 进行 远程 访问 中 的 特权 操 作 ， 请 按 
照 通 过 以 太 网 使 用 SSH Root 账 户 登 录 (第 42 页 ) 中 的 说 明 进 行 操作 。 


您 元 需 使 用 root 账 户 进行 登录 ， 请 跳 过 此 步骤 。 


4. 打开 终端 窗口 并 运行 : 


以 下 命 令 使 用 user 账 户 为 例 。 如 您 需 使 用 root 账 户 进行 登录 ， 请 按照 第 3 步 操 
作 执 行 ， 并 将 下 面 命令 中 的 user 改 为 root。 


sshUuseral92 D168 1 xxx 


(i) 提示 : 


192.168.1.xxx 为 肪 :星光 2 的 IP 地 址 。 
5. 根据 提示 键入 密码 starfive。 
结果 : 
您 成 功 在 Mac/Linux 下 通过 SSH 连 接 到 肪 :星光 21 


i 提示 : 


192.168.1.xxx 为 肪 :星光 2 的 IP 地 址 。 


图 3-9 示例 输出 
:~$ ssh user@192.168.120.70 


user@192.168.120.70's password: 
Linux starfive 5.15.0-starfive #1 SMP Thu Sep 29 15:10:06 EDT 2022 riscv64 


The programs included with the Debian GNU/Linux System are free software; 


the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 


Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent 
permitted by applicable law. 

Last login: Mon Nov 7 04:21:09 2022 

user@starfive:~# 
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3.4.3. 使 用 USB 转 串口 转换 器 连接 并 登录 


您 可 以 使 用 USB 转 串口 转换 器 连接 并 登录 到 Debian 操 作 系 统 。 请 根据 您 的 操作 系统 ， 选 择 相 
应 步骤 执行 : 


。Windows 系 统 (第 28 页 ) 
。Mac/Linux 系 统 (第 30 页 ) 


3.4.3.1. Windows 系 统 
步骤 : 
1. 将 烧 录 好 Debian 镜 像 的 Micro SD 卡 插 入 到 肪 :星光 2。 
2. 将 USB Type-C 数 据 线 的 一 端 连 接 到 防 .星光 2 上 ， 将 另 一 端 连 接 到 电源 适配器 上 。 
3. 将 USB 转 串口 转换 器 的 跳 线 连接 到 防 .星光 2 的 40-Pin GPIO Header 上 ， 如 下 图 : 
图 3-10 接 跳 线 


GPIO58 (I2C SDA) 3 SVPower 
GPIO57 (I2C ScL) 5 I GND 

Gplo55 了 GPIOS (UART TX) 
GND 9 10 GPIO6 (UARTRX) 
GPlo42 11 12 GPpl038 

GPIO43 13 14 GND 

GPI047 15 16 GPplO54 

3.3V Power “Ed 17 18 GPIO51 

GPIO52 (SPI MOSI) 19 20 GND 

GPIO53 (SPI MISO) 21 22 GPIO50 

GPplO48 (SPI SCLK) 23 24 GPIO49 (SPICEO) 
GND 25 26 GPIO56 

GPIO45 27 28 GPIO40 

Gplo37 29 30 GND 

GPIO39 31 32 GPl046 (PWMO) 
GPlo59 (PWM1) 33 34 GND 

GPIO63 35 36 GPIO36 

Gplo60 37 上 38 GPplO61 

GND 39 40 GPplO44 


4. 连接 USB 转 串口 转换 器 到 计算 机 上 。 
5. 在 Window 搜 索 栏 上 输入 并 搜索 Device Manager (设备 管理 器 ) 。 


6. 点 击 并 下 拉 Ports (COM & LPT) 选项 ， 找 到 连接 好 的 USB Serial Device (如 
COM4) 。COM4: 
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图 3-11 示例 


起 Device Manager 


File Action View Help 
旬 四 | 国 | 上 回国 男 


~ 于 DESKTOP-90AHHE7 
种 Audio inputs and outputs 
司 Biometric devices 
日 Bluetooth 
国 Computer 
i Disk drives 
国 Display adapters 
蕃 Firmware 
人 Human Interface Devices 
“= IDE ATA/ATAPI controllers 
E Keyboards 
国 Mice and other pointing devices 
国 Monitors 
上 Network adapters 
BY? other devices 
Ports (COM & LPT) 
最 Communications Port (COM1T) 


出 USB Serial Device (COM4) 
一 Print queues 
口 Processors 


7. 访问 此 链接 下 载 并 安装 Putty。 


个 提示 : 
Putty 是 SSH 和 telnet 客 户 端 ， 您 可 以 通 
Putty， 请 跳 过 此 步骤 。 
8. 打开 Putty 以 将 计算 机 连接 到 单 板 计算 机 。 
a. 在 Connection Type 下 选择 Serial。 


b. 设置 如 下 : 


过 


它 连 接 到 单 板 计 算 机 。 如 果 已 经 安装 了 


。Serial line: COM4 (选择 您 的 COM 端 口 ) 


。Speed: 115200 


29 
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图 3-12 示例 设置 


包 puTTy Configuration Cs xX 
Category: 
-Session Basic options for your PuTTY session 
Logging Specify the destination you wantto connectto 
Jo- Terminal Pp Y 
| Keyboard Serialline Speed 
Bell COM4 115200 
二 Neds Connection type 
Tr ORaw OIelnet ORlogin OSSH (©® Seral 
Appearance 
Behaviour Load. save or delete a stored session 
Translation 
由 -Selection Saved Sessions 
Colours | 
局 -Connection 
Default Settings 
Data I 9 Load 
Proxy 
Telnet Save 
Fingin Delete 
由 .SSH 一 
Serial 
Close window on exit R 
OAWways ONever (®) Only on clean exit 


Abou Hep Cancal 
c. 点 击 Open。 
9. 启动 肪 :星光 2。 
10. 输入 以 下 用 户 名 及 密码 : 
注 : 
您 可 使 用 root 或 user 用 户 名 进行 登录 。 以 下 示例 使 用 的 是 user 进 行 登录 。 
* Username: user 
* Password: starfive 
结果 : 
您 成 功 在 Windows 下 通过 USB 转 串口 转换 器 连接 到 防 .星光 21 
图 3-13 示例 输出 


starfive ttyS0 


opyright. 
LY NO WARRA 4 O the extent 


TC 2022 on ttyS0 


3.4.3.2. Mac/Linux 系 统 
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1. 将 烧 录 好 
2. 将 USB Ty 


3.3V Power 
GPIO58 (I2C SDA) 
GPIO57 (I2C SCL) 
GPIOSS 

GND 

GPIO42 

GPIO43 

GPIO47 

3.3V Power 
GPIOS2 (SPI MOSI) 
GPIOS3 (SPI MISO) 
GPIO48 (SPI SCLK) 
GND 

GPIO45 

GPIO37 

GPIO39 

GPIOS59 (PWM1) 
GPIO63 

GPIO60 

GND 


Debian 镜 像 的 Micro SD 卡 插入 到 了 上 . 星 光 2。 


pe-C 数 据 线 的 一 端 连 接 到 防 .星光 2 上 ， 将 另 一 端 连接 到 电源 适配器 上 。 
3. 将 USB 转 串口 转换 器 的 跳 线 连接 到 防 .星光 2 的 40-Pin GPIO Header 上 ， 如 下 图 : 
图 3-14 接 跳 线 


GND 
GPIOS (UART TX) 
GPIO6 (UART RX) 
GPIO38 

GND 

GPIO54 

GPIO51 

GND 

GPIO50 

GPIO49 (SPI CEO) 
GPIO56 

GPIO40 

GND 

GPIO46 (PWMO) 
GND 

GPIO36 

GPIO61 

GPIO44 


4. 连接 USB 转 串口 转换 器 到 计算 机 上 。 
5. 打开 Mac/Linux 终 端 窗口 。 


6. 运行 以 下 


命令 以 更 新 软件 包 列 表 : 


sudo apt=get update 


7. 运行 以 下 


命令 安装 minicom : 


sudo apt-get install minicom 


8. 运行 以 下 


dmesg | 


命令 查看 连接 中 的 串口 设备 : 


Oeme ey 


图 3-15 示例 输出 


$ dmesg | grep tty 
.134738] printk: console [ 0] enabled 
.382696 ] S2: LSR safety check engaged ! 


.383989 ] S2: LSR safety check engaged ! 
.5903061] Usb 2-2: pL2363 converter now attached to 
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行 以 下 命令 连接 到 串口 设备 : 


sudo minicom -D /dev/ttyUSBO -b 115200 


注 : 


波 特 率 (baud rate) 设置 为 115,200。 


图 3-16 示例 输出 
:~$ sudo minicom -D /dev/ttyUSBO -b 115200 
[sudo] password for ryan: 


Welcome to minicom 2.7.1 

OPTIONS: I18n 

Compiled on Aug 13 2017, 15:25:34. 
Port /dev/ttyUSBO, 00:03:16 


Press CTRL-A Z for help on special keys 


10. 局 动 防 .星光 2。 
11. 输入 以 下 用 户 名 及 密码 : 
注 : 
您 可 使 用 root 或 user 用 户 名 进行 登录 。 以 下 示例 使 用 的 是 user 进 行 登录 。 
。 Username: user 
。 Password: starfive 
结果 : 
您 成 功 在 MacOS/Linux 下 通过 串口 连接 到 防 : 星 光 21 
图 3-17 示例 输出 


WARRANTY, to the extent 


on ttyS0 


3.5. 避免 运行 apt upgrade 


在 登录 Debian (第 2 在 当前 状态 下 ， 避 免 运行 apt _ upgrade 命令 ， 因 为 它 将 覆盖 掉 
。 
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3.6. 在 SD 卡 和 eMMC 上 扩展 分 区 


登录 Debian 后 ， 为 充分 利用 SD 卡 上 未 使 用 的 空 
eMMC 的 分 区 : 


1. 执行 以 下 命令 ， 列 出 可 使 用 的 磁盘 空间 : 


间 ， 


请 执行 以 下 步骤， 扩展 上 防 .星光 2 SD 卡 和 


~# df -—h 

输出 示例 : 

Filesystem Size Used Avail Uses Mounted on 
udeyv SR 0 3.76 0% /dev 

tmpfs 793M 3.1M 790M 1% /run 
/dev/mmcblklp4 2.0G 1.9G 88M 96% / 

tmpfs 3.9G 0 3.9G 0% /dev/shm 
tmpfs 5.0M 12K 5.0M TS /run/locn 
tmpfs 793M 32K 793M 1 /run/user/107 
ms 793M 24K 793M 1% /run/user/0 


2. 以 磁盘 名 作为 参数 运行 faisk 命 令 。 


命令 示例 : 


root@starfive:~# fdisk /dev/mmcblk<X> 


(i) 提示 : 


<X>: 变 


1=| 


时 


示例 输出 


root@starfive:~# fdisk /dev/mmcblkl1 


Welcome Eo fdisk (本 下 im 2.38.1 


Changes Will remain in memory only, 


值 为 0 或 1。SD 卡 取 1，eMMC 取 0。 


Ds 
until you decide to write them. 


Be careful before using the write command. 


GPT PMBR size mismatch 


write. 


(45053599 


S29290mM00winNe oe eorreeceeny 


This disk current in use ™— repartitioning is probably a bad idea. 


It's recommended to umount all file 
oeueE telone on chile Chale. 

(el 

default 4) : 


Command (m for help): 


Baneneeommumeern( il 4 
Partition 4 has been deleted. 
Command (m for help): 
(2 


和 


Parelnenion namober default 4) 


systems, and swapoff all swap 


4 


A 
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First sector (34-62929886, default 221184) : 
Last sector, +/-sectors or +/-size{K,M,G,T,P} 
(221184-62929886, default 62928895) : 


Created a new partition 4 of type 'Linux filesystem' and of size 29.9 
GiB. 

Partition #4 contains a ext4 signature. 

Do you want to remove the signature? [Yl]jes/[N]o: N 


Command (m for help): w 


The partition table has been altered. 
Syncing disks. 


3. 执行 resize2fs 命 令 调整 /dev/mmcblk<X>p4 分 区 的 大 小 ， 以 充分 利用 未 使 用 的 块 。 


人 @@ 提示 : 


<X>: 变量 值 为 0 或 1。SD 卡 取 1，eMMC 取 0。 


示例 命令 和 输出 : 


root@starfive:~# resize2fs /dev/mmcblklp4 

resize2fs 1.46.6-rcl (12-Sep-2022) 

Filesystem at /d[ 295.372617] EXT4-fs (mmcblklp4): resizing filesystem 
Om 54520l 0 VIIAG4 lOOIE 

ev/mmcblklp4 is mounted on /; on-line resizing required 

old. desc blocks = 1, new assc 和 oalke 会 4 

[ 295.993163Y EXT4-fs (mmcBlk1ip4): resized filesystem to 7838464 

The filesystem on /dev/mmcblklp4 is now 7838464 (4k) blocks long. 


验证 : 
执行 af =h 命 令 以 验证 分 区 的 新 大 小 ， 并 验证 扩展 分 区 (/dev/mmcblk<X>p4) 的 步骤 
是 合成 功 。 


0 提示 : 


<X>: 变量 值 为 0 或 1。SD 卡 取 1，eMMC 取 0。 


以 下 输出 表示 修改 成 功 : 


root@starfive:~# df -h 


Filesystem Size Used Avail Uses Mounted on 
udeyv 9 7 0 S376 0% /dev 
tmpfs 793M 3.1M 790M 1 /ev 
/dev/mmcblk1lp4 30G 1.9G 28G TE 7 
tmpfs 3 .9G 0 3.9G 0% /dev/shm 
tmpfs 5.0M 12 OM 1% /oy Noe 
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tmpfs 793M 32K 793M 1%$ /run/user/107 
tmpfs 793M 24K 793M 1% /run/user/0 


3.7. 安装 软件 包 


安装 基本 的 软件 包 
您 可 以 通过 安装 软件 包 来 改善 整体 用 户 体 验 ， 包 括 : 
。 VIM 


。nautilus (Gnome 文 件 查 看 器 ) 


安装 赛 防 科技 提供 的 软件 包 
以 下 是 赛 防 科技 提供 的 软件 安装 包 : 


有 些 软件 包 无 法 通过 apt/apt-get 下 载 ， 因 此 由 赛 防 科技 提供 ， 其 中 包括 (以 202306 文 件 夹 
中 的 最 新 脚本 为 例 ) : 


。NodeJs 18.0.0 

* v8 10.2.154.13 

* libsdl2-dev 

“QT 5.15.2 

* Firefox 105.0 

* Libreoffice 7.5 

* NW'.js 

。FFmpeg 

“。Gstreamer 

* v4l2test (使 用 CSI 相 机 的 自 定义 shell 脚 本 ) 

。Chromium 103 

。VLC 3.0.18 
赛 上 科 技 软件 包 的 Debian 仓 库 : Github 链 接 
仓库 中 已 提供 有 脚本 (及 其 运行 时 需要 的 依赖 项 ) ， 您 直接 运行 脚本 即 可 安装 。 
您 只 需要 运行 以 下 脚本 : 


注 : 


请 确保 防 .星光 2 在 运行 脚本 前 已 连 网 。 
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wget 
https://github.com/starfive-tech/Debian/releases/download/v0.8.0-engineerin 
g-release-wayland/install package_and dependencies.sh 

chmod +x install package_ and_ dependencies.sh 

sudo ./install package_ and dependencies.sh 


3.8. 更 新 SPL 和 U-Boot 


3.8.1. 更 新 Flash 中 的 SPL 和 U-Boot 


以 下 提供 更 新 上 . 星 光 2 Flash 中 的 SPL 和 U-Boot 的 两 种 方法 : 


注 : 
如 需 获 取 创 建 SPL 和 fw_payload (U-Boot) 文件 的 参考 手册 ， 请 参阅 《 肪 :星光 2 单 
板 计 算 机 软件 技术 参考 手册 》 中 的 “创建 SPL 文 件 " 和 “创建 fw_payload 文 件 "。 


1. 通过 tftpboot 命 令 更 新 SPL 和 U-Boot。 


2. 通过 flashcp 命 令 更 新 SPL 和 U-Boot。 


因 注 : 


方法 2 仅 支 持 镜像 版 本 为 VE2_v2.5.0 或 高 于 该 版 本 的 镜像 。 


人 


通过 tftpboot 命 令 
通过 tftpboot 命 令 更 新 SPL 和 U-Boot， 请 执行 以 下 步骤 : 
1-7 步 是 在 主机 PC 上 进行 ，8-13 步 是 在 肪 :星光 2 上 进行 。 
1. 将 以 太 网 电缆 的 一 端 连接 到 肪 :星光 2 RJ45 接 口上 ， 将 另 一 端 连接 到 路 由 器 上 。 
2. 在 主机 PC 上 安装 TFTP 服 务 器 : 


sudo apt-get update 
sudo apt install tftpd-hpa 


3. 检查 服务 器 状态 : 


sudo systemctl1 status tftpd-hpa 


4. 输入 以 下 命令 进入 TFTP 服 务 器 : 
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sudo nano /etc/default/tftpd-hnpa 


5. 执行 以 下 命令 设置 TFTP 服 务 器 : 


TFTP_USERNAME="tftp" 
TFTP_DIRECTORY="/home/user/Desktop/tftp_share" 
TFTP_ ADDRESS=":69" 

TFTP_ OPTIONS="-—-secure" 


注 : 
TFTP_DIRECTORY 指 bootloader、u-boot、SPL 和 镜像 等 文件 的 存放 路 径 。 
6. 执行 以 下 命令 ， 创 建 tftp-server 文 件 夹 以 存储 文件 : 


sudo mkdir -p /home/user/tftp 


7. 重启 TFTP 服 务 器 : 


sudossysecemet restare etepo na 


8. 打开 有 妨 : 星 光 2， 等 待 它 进 入 U-Boot 命 令 行 界面 。 


(i) 提示 : 
° 前 提 条 件 : 


。 一 个 USB 转 TTL 转 换 器 ， 将 USB 连 接 到 电脑 ， 杜邦 线 连接 到 防 .星光 
2 正确 的 扩展 引 脚 上 ,， 特 别 注意 TX 和 RX 需 要 交叉 对 接 


。 在 您 的 电脑 上 安装 Putty 或 者 secureCRT 等 


* 当 您 给 防 .星光 2 上 电 后 ， 串 口 会 打印 数字 并 且 进 行 递减 计时 ， 一 般 是 从 3 
开始 递减 ， 在 数字 减 为 0 之 前 点 击 任意 按键 就 可 以 进入 U-Boot 的 命令 行 模 
于 


9. 执行 以 下 命令 设置 环境 变量 : 


setenv ipaddr 192.168.120.222;setenv serverip 192.168.120.99 


股 情况 下 路 由 器 的 默认 lp 为 192.168.120.1。 在 这 种 情况 下 ， 请 使 用 由 路 由 器 
的 DHCP 服 务 器 分 配 的 IP， 防 :星光 2 的 IP 地 址 应 为 192.168.120.xxx。 但 是 ， 如 果 
您 的 路 由 器 IP 不 同 (例如 192.168.2.1) ， 请 确保 服务 器 IP 和 了 肪 .星光 2 属于 同一 IP 
段 (例如 192.168.2.xxx) 中 。 


10. 使 用 ping 命 令 ， 检 查 主 机 与 防 .星光 2 的 连接 情 ; 
示例 命令 
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Slo S28 20.99 


结果 : 
以 下 输出 表明 主机 与 肪 :星光 单 板 计算 机 已 经 在 同一 网 络 下 建立 连接 。 


Seamnive ww Dlne 92.168.120.59 
speed: 1000, full duplex 
Using dwmac.10020000 device 
nese 9201 L200 © ey el al 


11. 初始 化 SPI flash: 


sf probe 


结果 : 


StarFive # sf probe 
SF: Detected gd251q128 with page size 256 Bytes, erase size 4 KiB， 
total 16 MiB 


12. 更 新 SPL 二 进 制 文件 ， 以 下 为 命令 和 示例 输出 : 


StarFive # tftpboot Oxa0000000 ${serverip}:u-boot-spl.bin.normal.out 
Using ethernet@16030000 device 

TETPfromserver1o92.168°120%990% ouUur le Waddress S92.168.120.222 
Filename ‘u-boot-spl.bin.normal.out’. 

Load address: 0xa0000000 

Loadinqg: #### 间 间 间 间 间 间 # 

1.6 MiB/s 

done 

Bytes transferred = 132208 (20470 hex) 

StarFive # sf update 0xa0000000 0x0 $filesize 

eleyice 0 cffsEeW EDhze 0x20470 

Ooyteemwaer, 1322080bytes skipped in 0.23s, speed 5206961 B/s 


13. 更 新 U-Boot 二 进 制 文件 ， 以 下 为 命令 和 示例 输出 : 


StarFive # tftpboot 0xa0000000 ${serverip}:visionfive2_ fw payload.img 
Using ethernet@16030000 device 

TETPOfrOmM Semmes 1168. 120.900% ourTPp adgdress Ss]19%.168.120.222 
Filename ‘visionfive2_ fw payload.img’. 
Load address: 0xa0000000 
Loading: 

磊磊 间 提 非 井 井 提 间 六 六 六 提 提 井 井 提 音 提 六 提 提 提 井 井 提 六 六 术 提 提 提 井 提 非 提 六 六 提 提 提 井 提 提 六 扩 术 提 提 提 井 提 提 六 六 提 提 提 提 井 提 提 六 间 着 
非 间 间 提 提 非 井 提 大 六 六 提 提 提 提 提 提 提 六 六 提 提 提 井 井 捍 间 六 扩 提 提 提 井 提 捍 提 六 术 提 提 提 井 提 捍 提 六 间 提 提 提 井 提 提 六 六 六 提 提 提 井 提 提 六 提 拓 
非 间 间 提 非 非 井 提 间 六 六 六 提 提 井 提 捍 提 六 术 提 提 提 井 井 提 六 六 术 提 提 提 井 提 捍 提 六 扩 提 提 提 井 提 提 六 扩 术 提 提 提 井 提 捍 间 六 提 提 提 井 井 提 间 提审 着 
太 ### 非 间 ## 非 
252 MiB/E 
done 
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Bytes transferred = 2955397 (2d1885 hex) 

StarFive # sf update 0xa0000000 0x100000 $filesize 

cevaies 0 snase O00O00000 SizeS (2c03e5 

Omeyees wi een 2 yees Led no seed es 


StarFive #t 
通过 flashcp 命 令 
通过 flashcp 命 令 更 新 SPL 和 U-Boot， 请 执行 以 下 步骤 : 


注 ， 


方法 2 仅 支 持 镜像 版 本 为 VF2_v2 .5 . 0 或 高 于 该 版 本 的 镜像 。 


1. 执行 以 下 命令 ， 安 装 mtdq-utils 安 装 包 : 


apt install mtd-utils 


2. 通过 SCP 将 最 新 的 u-boot- 
spl.bin.normal.out 和 visionfive2_fw_payload.img 文 件 移 植 到 Debian 系 统 
EE 


3. 执行 以 下 命令 ， 查 看 MTD 分 区 : 
cat /proc/mtd 


示例 输出 : 
您 可 以 看 到 QSPI Flash 里 的 数据 分 区 : 


deyv: size erasesize name 
mtd0: 00020000 00001000 "spl" 
mtdl: 00300000 00001000 "uboot" 
mtd2: 00100000 00001000 "data" 


4. 根据 不 同 分 区 的 内 容 ， 分 别 通过 f1ashcp 更 新 SPL 和 U-Boot: 
“更 新 SPL 的 示例 命令 : 
flashcp -~v u-boot-spl.bin.normal.out /dev/mtad0 
。 更 新 U-Boot 的 示例 命令 : 
flashcp -v visionfive2 fw payload.img /dev/mtdl 
示例 命令 和 输出 : 


# flashcp -Vv u-boot-spl.bin.normal.out /dev/mtd0 
Deen IOLOGCERE 2/32 (LO00%S) 

Wenelne eeeas L244/1224] (L100%) 

Verifying data: 124k/124k (100%) 
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# flashcp -v visionfive2 fw payload.img /dev/mtdl 
Erasing blocks: 682/682 (100%) 
Wenelne CeeEas 2727/2727 (100%) 
Verifying data: 2727k/2727k (100%) 


5. 重启 系统 ， 以 使 更 新 生效 。 


3.8.2. 更 新 SD 卡 和 eMMC 中 的 SPL 和 U-Boot 


要 更 新 SD 卡 和 eMMC 中 的 SPL 和 U-Boot， 请 执行 以 下 步骤 : 


1. 通过 SCP 将 最 新 的 U-Boot- 
spl.bin.normal.out 和 visionfive2_fw_payload.img 文 件 移植 到 Debian 系 统 
ES 


2. 更 新 SPL。 

dq if=u-boot-spl.bin.normal.out of=/dev/mmcblk<X>pl conv=fsync 
3. 更 新 U-Boot。 

dq if=visionfive2_fw_ payload.img of=/dev/mmcblk<X>p2 conv=fsync 


i 提示 : 


<X>: 变量 值 为 0 或 1。SD 卡 取 1，eMMC 取 0。 


示例 命令 和 输出 : 


root@starfive:~# dd if=u-boot-spl.bin.normal.out of=/dev/mmcblk1lpl 
Conv=fSynNc 

255+1 BecordsS 

2551+10EScords Out 

13068emoyt ecm ee 128 alB) copied, 0.033136 s, 3.9 MB/Ss 
root@starfive:~# dd if=visionfive2_fw_ payload.img of=/dev/mmcblk1lp2 
Convy= fsync 

5469 同 assels ”1Dn 

5469+1 records erE 

280050TUDYEE RS MB, 20 MiB) copied, OSIL9333US RS5UMBS 


3.9. 编译 和 更 新 Linux 内 核 


按照 以 下 步骤 ， 编 译 和 更 新 Linux 内 核 : 
1. 执行 以 下 命令 ， 安 装 依赖 包 以 创建 内 核 : 


apt-get install build-essential linux-source bc kmod cpio flex 
libncurses5-dev libelf-dev libssl-dev dwarves bison git 
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2. 从 赛 防 科技 Github 仓 库 取 内 核 文件 : 


giteclone ES 有 本 5 有 有 有 


3. 下 载 所 需 内 核 版 本 : 


git checkout <Tag Version> 


4. 使 用 bingeb-pkg 创 建 内 核 : 


cd linux/ 

ep arch/risev/Configs/starfive rvisionfive2 defeconfig .Confsrg 
make ARCH=riscv olddefconfig 

make ARCH=riscv -j$ (nproc) bindeb-pkg 


5. 编译 完成 后 ， 安 装 .depb 内 核 软件 包 。 
clokem elel 
目前 ， 安 装 了 不 同 版 本 的 内 核 ，dtb 文 件 将 不 会 同步 ， 您 需要 将 dtb 文 件 从 / 


usr/lib/linux-image-<custom version>/starfive 路 径 复 制 到 / 
booty/dtbs/ 路 径 下 。 
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4. 附录 


4.1. 自 定 义 Debian 


更 多 详细 信息 ， 请 参阅 上 . 星 光 2 Debian 用 户 指 南 中 Debian 用 户 指南 一 节 。 


4.2. 通过 以 太 网 使 用 SSH Root 账户 登录 


重新 安装 系统 后 ， 默 认 禁 用 Debian Linux 上 的 root 进 行 登录 。 当 您 试图 以 root 的 身份 登录 到 
Debian Linux 服 务 器 时 ， 您 的 访问 将 被 拒绝 。 以 下 是 示例 信息 : 


$ ssh root@192.168.120.41 
ssh: connect to host 192.168.120.41 port 22: Connection refused 


若 要 局 用 SSH root 身 份 登录 ， 请 执行 以 下 步骤 : 
1. 运行 以 下 命令 配置 SSH 服 务 器 : 


echo 'PermitRootLogin=yes' | sudo tee -a /étc/ssh/sshd config 


2. 重启 SSH 服 务 器 : 


sudo systemctl1 restart sshd 


结果 : 
您 可 以 用 root 用 户 身份 使 用 SSH 登 录 了 。 如 输出 以 下 结果 ， 则 表示 登录 成 功 : 
示例 输出 


Sissh rooteloemlo8. A001] 
IS® Ot aa .41 "EMeassword: 
LinuxMstarfive 5.15M0 starfive #1 SMP Fri Feb 24 03:26:44 EST 2023 


riscv64 


The programs included with the Debian GNU/Linux system are free 
software; 

the exact distribution terms for each program are described in the 
individual files in /usr/share/doc/*/copyright. 


Debyan GNU/Linux COmes with ABSOLUTELY NO WARRANTY, to the extent 
permitted by applicable law. 
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COMOD 太 2 
root@starfive:~# 


3. 使 用 root 账 户 进行 登录 ， 请 参见 通过 以 太 网 使 用 SSH 登 录 (第 25 页 )。 


4.3. 恢复 Bootloader 


J Boot 储 存在 SPI flash 中 。 您 可 能 会 意外 清空 闪存 ， 或 者 肪 :星光 2 的 闪存 损坏 。 在 这 些 
青 况 下 ， 我 们 需要 重 置 Bootloader。 


1. 将 USB 转 串口 转换 器 的 跳 线 连 接 到 防 .星光 240-Pin GPIO Header 的 Debug pin 上 。 下 图 为 
示例 : 


图 4-1 连接 防 .星光 240-Pin GPIO Header 的 Debug Pin 


GPIO58 (I2C SDA) 3 4 lBVPower 
GPIO57 (I2C scL) 5 6 GND 

Gpl055 7 8 GPIO5(UARTTX) 
GND 9 10 GPIO6 (UARTRX) 
GpI042 11 12 GPl038 

Gpl043 13 14 GND 

GpI047 15 16 GPIO54 

3.3V Power 17 18 GPIOS1 

GPIOS2 (SPI MOSI) 19 20 GND 

GPIO53 (SPI MISO) 21 22 GPpIO50 

GpIO48 (SPI SCLK) 23 24 GPIO49 (SPICEO0) 
GND 25 26 GPIO56 

GPIO45 2 28 GPIO40 

GPIO37 29 30 GND 

GPplO39 31 32 GPpl046 (PWM0) 
GPIO59 (PWM1) 33 34 GND 

GPIO63 35 36 GPIO36 

GPIO60 37 38 GPIO61 


GND 39 40 GPIO44 


2. 在 您 恢复 bootloader 前 ， 请 再 次 检查 防 .星光 2 上 的 局 动 模式 跳 线 (Switch_2) 已 经 切换 
为 UART 模 式 (RGPIO 1，RGPIO 0: 1,1) 。 


@ 提示 : 


下 图 为 启动 模式 设置 。 更 多 信息 请 参见 防 .星光 2 启动 模式 设置 (第 49 页 )。 
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@ 图 4-2 启动 模式 设置 (UART) 


1 (High Level) 0 (Low Level) 


3. 将 串口 波 特 率 设 置 为 115200 bps。 
4. 上 电 后 ， 输 出 如 下 : 


eeeeeeeeeeecEcEcEcee 


5. 通过 XMODEM， 传 输 恢复 二 进 制 文件 (jh7110-recovery-<Version>.bin) 。 恢 
复 二 进 制 文件 地 址 为 : https://github.com/starfive-tech/Tools/tree/master/recovery。 


@ 提示 : 


<Version> 表 示 二 进 制 文件 的 版 本 号 。 请 确保 您 使 用 的 是 最 新 的 版 本 。 


Tera Term: XMODEM Send 4 


Filename: |ih7110-recovery-2022 
Protocol: XMODEM [CROC] 


Packet#: 250 
Bytes transferred: 32000 
Elapsed time: 0:07 (4.44KBI}s) 


加 19.4% 
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[ClStarF ivwe 

[CCCCCCCCCCC 

JH?110 secondboot version: 221205-?4596a9 

CPU freq: 1250HHz 

idcode: 0»x1860C8 

Cs0:0xd00f0032 Dx8f5903ff Dsffffffef Ox8ad04023 


en Speed: 25000000 

Rd Block Len: 512 

HHC wersion 4.0 

High Capacity: Yes 
[apacitu: 29.1 GiB 

Bus Hidth: 8-bit 

Erase Broup Size: Dx80000 
ddr Dx00000000, dH test 
ddr Ox00400000, 8H test 
DOR clk 2133H, size 86B 


站 
: update 2ndbootZSPL in flash 
: update 2hdbootZSPL in ernc 
: Update fu verifi/uboot in flash 
: Update fy verif/uboot in ernc 
: update otp, caut ion!!!! 
: e8it 


0TE: current wnoden receive buff = Dx40000000, 


select the function to test: 


load [stepkkkk” to change. 


6. 输入 0， 按 Enter 键 更 新 SPL 二 进 制 文件 <u-boot-spl.bin.normal.out>。 
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图 4-5 示例 输出 


24 和 和 2 和 ck 


L in flas 
L in ehHc 
2: update fy verif/uboot in flash 
3: update fu ruboot in enHc 
4: update otp, caution!!!! 
: exit 
NOTE: current wnoden receive 


Tera Term: XMODEM Send x 


Filename: lu-boot-spl.bin.normal. 
Protocol: xMODEM [CRC] 
Packeit#: 144 
Bytes transferred: 18432 
Elapsed time: 0:04 [4.28KBy)s] 


14.426 


Cancel 


file b 
pdata first sect ion 


1: update 2 
2: update fu" ruboot in flash 
3: update f ruboot in ehHc 
4: update 
“it 
we buff = Oxd0000000, ?load Owek’ to change。 


7. 输入 2， 按 Enter 键 更 新 U-Boot 二 进 制 文件 <visionfive2_fw_payload.img>。 
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图 4-7 示例 输出 


下 下 下- 下- 下- 


: Update 
: update 
update 

3: update ff 
: update 


it 


Filename: visionfive2_fw_paylos 
Protocol: XMODEM [CRC]) 
Packet#: 282 
Bytes transferred: 36096 
Elapsed time: 0:07 [4.09KB/s) 


1.3% 
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updata sur 


tttotototottotottottotottotototottot* CH 水 
too ok 
中 和 


: update endb 
2: Update fu y oot in flash 
: Update fy_verif /uboot in ennc 
: Update otp，caut ion 
: exit 
current %HodeH receive buff = Dxd0000000, load Deepeekekkk” to change。 
select the function to test : 


8. 关闭 电源 并 将 跳 线 切换 回 Flash 模 式 (RGPIO_1，RGPIO 0: 0，0) 。 


4.4. GitHub 代 码 仓 地 址 


下 表 列 出 了 GitHub 仓 库 的 地 址 : 


注 : 


确保 您 已 经 切换 到 了 对 应 分 支 。 


表 4-1 GitHub 仓 库 地 址 
分 支 


JH7110 VisionFive2 _ devel 


Linux 代 码 仓 下 的 。 jh7110.dtsi 


DTS 文 件 。 jh7110-visionfive-v2.dts 


。 jh7110-visionfive-v2.dtsi 


JH7110 VisionFive2 devel 
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表 4-1 GitHub 仓 库 地 址 ( 续 ) 
类 型 仓库 


OpensBl OpenSBel master 


om em 
4.5. 肪 :星光 2 启动 模式 设置 


防 .星光 2 提供 专门 的 pin， 帮 助 用 户 在 上 电 前 配置 启动 模式 。 以 下 是 可 选 的 启动 模式 及 其 详细 
三 自 


eo 


表 4-2 启动 模式 设置 


index 启动 模式 KE 1 Tm- 气 属 0 
EE | 1-bit QSPI Nor Flash 


SDIO3.0 
和 eMMC 0(D) 


4 ur RN 


注 : 
赛 防 科技 建议 您 使 用 1-birQSPIJ Nor Flash 模 式 启动 ， 因 为 使 用 eMMC 或 5DIO3.0 启 动 
模式 可 能 会 发 生 小 概率 启动 失败 的 情况 。 如 果 从 eMMC 或 SDIO3.0 启 动 失 败 ， 您 可 以 
尝试 重启 肪 :星光 2。 


下 图 显示 了 局 动 模式 专用 pin 的 位 置 及 其 定义 。 
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图 4-9 启动 模式 设置 位 置 


1 (High Level) 0 (Low Level) 
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图 4-10 启动 模式 设置 


QSPI 


RGPIO_1: 0 (L) 
RGPIO_0: 0 (L) 


SDIO 


RGPIO_1: 0 (L) 
RGPIO_0: 1 (H) 


eMMC 
RGPIO_1: 1 (H) 
RGPIO_0: 0 (L) 


UART 


RGPIO_1: 1 (H) 
RGPIO_0: 1 (H) 


Note: H for high level; L for low level. 


开发 板 版 本 不 同 ， 丝 印 可 能 也 不 同 。 
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